package org.nnxy.foodboot.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.nnxy.foodboot.entity.UserFavorite;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 用户收藏服务接口
 */
public interface UserFavoriteService extends IService<UserFavorite> {
    
    /**
     * 添加用户收藏
     * @param userId 用户ID
     * @param recipeId 食谱ID
     * @param note 备注（可选）
     * @return 是否成功
     */
    boolean addUserFavorite(Integer userId, Integer recipeId, String note);
    
    /**
     * 取消用户收藏
     * @param userId 用户ID
     * @param recipeId 食谱ID
     * @return 是否成功
     */
    boolean removeUserFavorite(Integer userId, Integer recipeId);
    
    /**
     * 获取用户收藏列表
     * @param userId 用户ID
     * @return 收藏列表
     */
    List<UserFavorite> getUserFavoritesByUserId(Integer userId);
    
    /**
     * 分页获取用户收藏
     * @param page 分页参数
     * @param userId 用户ID
     * @return 分页结果
     */
    Page<UserFavorite> getUserFavoritesPage(Page<UserFavorite> page, Integer userId);
    
    /**
     * 检查用户是否收藏了特定食谱
     * @param userId 用户ID
     * @param recipeId 食谱ID
     * @return 是否已收藏
     */
    boolean isRecipeFavorited(Integer userId, Integer recipeId);
    
    /**
     * 更新收藏备注
     * @param id 收藏记录ID
     * @param note 新备注
     * @return 是否成功
     */
    boolean updateFavoriteNote(Integer id, String note);
    
    /**
     * 统计指定时间范围内的收藏数量
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 收藏数量
     */
    long countByTimeRange(LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 获取收藏最多的食谱列表
     * @param limit 限制数量
     * @return 食谱列表
     */
    List<Map<String, Object>> getMostFavoritedRecipes(Integer limit);
} 